GFXFree.Net - Download Unique Web Templates And Scripts

WordPress Plugin for Integrating WHMCS

• created: 12/10/2014
• latest update: 09/02/2015
• by: WHMpress.com
• email: sales@whmpress.com

WHMpress makes it easy for you to sell web-hosting using WordPress & WHMCS. WHMpress fetches your hosting plan names, prices, order links & domain lists from WHMCS and shows in the form of fancy pricing tables, order combos, order buttons & domain price tables. It offers you Shortcodes to insert these elementss into your WordPress webhosting site exactly the way you want and where you want. Quickly build your website using WHMpress. Select your WHMCS elements, configure the options, and easily embed it into your WordPress powered Webhosting site.

Thank you for purchasing WHMpress WordPress plugin.

WHMpress is a unique plugin, it will help you quickly build your webhosting website with WordPress. If offers WHMCS elements that you can insert in your pages without coding a single line. If you have been manually inserting your hosting plans and prices in past, or taking helps of programmer to link WHMCS, those days are over.

We have prepared this Quick Start video for you to get you up and running. See yourself how easy it is to set up a webhosting website with WHMpress.

Installation & Activation

WHMpress installation is no different from any other plugin installation process, so you might be familiar with this process already. If you are not, you can follow these steps.

1. Login to your wordpress installation
2. Go to Plugins > Add New
3. Click Upload link
4. Browse to the downloaded plugin zip file (it is a file named whmpress.zip located within the zip file you downloaded from CodeCanyon, you will need to extract the package from CodeCanyon first) and choose whmpress.zip
5. Click "Install Now" button
6. Wait while plugin is uploaded to your server
7. Click "Activate Plugin" buttonStart Here will go here

FTP Installation

1. Upload the folder whmpress located within the package file you downloaded from CodeCanyon (you will need to extract the package from CodeCanyon first) using the FTP program of your choice in wp-content/plugins folder.
2. Go to Plugins screen and find the newly uploaded WHMpress plugin in the list.
3. Click Activate Plugin to activate it.

Updates

To update WHMpress from older version, please follow these steps.

1. Login to CodeCanyon and re-download WHMpress and extract it.
2. Now navigate to the Plugins menu in your WordPress admin area.
3. Deactivate WHMpress and then delete it.
4. Upload new version and Activate WHMpress. (All your settings will be retained)

WHMpress configures itself by fetching your configuration values from WHMCS. During the process it also fetches all your services and prices.

• Click WHMpress > Sync WHMCS
• Enter following info

WHMCS Database Sever
Mostly it is localhost, if WHMCS resides on a different server use its IP or hostname

Database Name
Name of the WHMCS database, it is the same name you used while installing WHMCS

Database User
database user name for WHMCS database

Password
database user password

• Click Sync WHMCS press.
• WHMpress will show the messages showing which information is being copied from WHMCS.
• Once done, click on settings and chose weather your want to order with or with SSL.

Once WHMpress is installed you will see its icon in editor. Select the component that you want to insert, select your service, customize look and feel (if you want to) and click ok.

For a detailed demonstration, see video below.

Displays price of a WHMCS Service (Hosting Plan) in lot of customization options. Service id is the only required parameters, will return “Invlid id”  if service id does not exist. If no other parameter is given yearly service price is returned.

[whmpress_price id = ""] 

Parameters

• id: Id of the service (Hosting Plan), You can find the IDs of all your services in WHMpress > Services/Products section. Click products/services link under WHMpress to see WHMCS services IDs.
• html_id: add a custom id to the table element for further CSS customization.
• html_class: Add a custom class to the wrapping HTML element.
• currency: Used with multi-currency, set the Currency in which price is displayed, if not mentioned session currency is used (which user have selected), if no session is found, currency set as default in WHMCS is used.
• billingcycle: Billing cycle of service, one from one-time, monthly, quarterly, semi-annually, annually, biennially, triennially. If skipped yearly price is returned.
• decimals: how many decimals to show, if skipped no decimals are displayed.
• Hide_decimal: hide decimal if needed
• decimals_tag: html tag to wrap decimals, e.g. strong, b, sup or sub
• prefix: currency prefix of selected or default currency, if skipped no currency prefix is displayed. Takes following options
  • yes = displays currency prefix
  • no = do not display prefix
  • sup = show as super script
  • sub = show as subscript

• suffix: currency suffix of selected or default currency, if skipped no currency suffix is displayed. Takes following options
  • yes = displays currency suffix
  • no = do not display suffix
  • sup = show as super script
  • sub = show as subscript
• show_duration: yes for show duration with price
  • sub = show as subscript
  • sup = show as super script
  • no = do not display
  • yes = displays duration (billing cycle)
• show_duration_as: format to show duration
  • long = displays complete duration e.g. year
  • short = show short duration e.g. yr
• convert_monthly: shows calculated monthly price based on duration selected in billing cycle.

Displays the name, details, price & order button or combo of a WHMCS Service (Hosting Plan) in lot of customization options. Service id is the only required parameters, will return “Invlid id”  if service id does not exist. If no other parameter is given yearly service price is returned.

[whmpress_price box id = ""] 

Parameters

• id: Id of the service (Hosting Plan), You can find the IDs of all your services in WHMpress > Services/Products section. Click products/services link under WHMpress to see WHMCS services IDs.
• html_id: add a custom id to the table element for further CSS customization.
• html_class: Add a custom class to the wrapping HTML element.
• currency: Used with multi-currency, set the Currency in which price is displayed, if not mentioned session currency is used (which user have selected), if no session is found, currency set as default in WHMCS is used.
• billingcycle: Billing cycle of service, one from one-time, monthly, quarterly, semi-annually, annually, biennially, triennially. If skipped yearly price is returned.
• Box_type: format to show box in
  • Default
  • Style1
• show_price: Display price or not
• show_combo: Show combo or not, No, Yes
• show_button: Show submit button or not

List all the services you offer along with prices and billing cycles in default currency. Used to show price matrix.

[whmpress_price_table html_id = "" ][/whmpress_price_table]

Parameters

• html_id: add a custom id to the HTML element for further CSS customization.
• html_class: Add a custom class to the apply to table.
• table_id: add a custom id to the table element for further CSS customization.
• currency: Used with multi-currency, set the Currency in which price is displayed, if not mentioned session currency is used (which user have selected), if no session is found, currency set as default in WHMCS is used.
• type: comma separated values of your service groups names or ids. No spaces in comma separated values.
• name: comma separated values of your package names.
• groups: comma separated values of your service groups names or ids. No spaces in comma separated values.
• billingcycles: Billing cycle of service, one from one-time, monthly, quarterly, semi-annually, annually, biennially, triennially. If skipped all billing cycles are returned.
• decimals: how many decimals to show, if skipped no decimals are displayed.
• show_hidden: weather to show plans set to hidden in whmcs, yes or no.
• replace_empty: Text to replace empty values, default value is “x”
• replace_zero: Text to replace if a package value is zero (free). Default value is “-“
• hide_search: Yes or No to hide or show search.

List all the domains that you offer along with price in table format and with search option for quick find.

[whmpress_price_table_domain html_id = ""][/whmpress_price_table_domain]

Parameters

• html_id: add a custom id to the wrapper HTML element for further CSS customization.
• html_class: Add a custom class to wrapper HTML element. (two builtin classes)
• table_id: add a custom id to the table element for further CSS customization.
• currency: Used with multi-currency, set the Currency in which price is displayed, if not mentioned session currency is used (which user have selected), if no session is found, currency set as default in WHMCS is used.
• show_tlds: comma separated values of tlds to to list in table. Only tlds that exists in WHMCS will be added. No spaces in comma separated values.
• show_tlds_wildcard: show only tlds matching with given string. Very useful if you want to show only tlds related to your country, e.g. “.in”
• hide_search: Yes or No to hide or show search.

Displays order button for given WHMCS Service (Hosting Plan). Service id is the only required parameters, if no other parameters is given yearly service price is returned.

[whmpress_order_button id = "" ] [/whmpress_order_button]

Parameters

• id: Id of the service (Hosting Plan), You can find the IDs of all your services in WHMpress > Services/Products section.
• html_id: add a custom id to the table element for further CSS customization.
• html_class: Add a custom class to the wrapping HTML element.
• currency: Used with multi-currency, set the Currency in which price is displayed, if not mentioned session currency is used (which user have selected), if no session is found, currency set as default in WHMCS is used.
• billingcycle: Billing cycle of service, one from one-time, monthly, quarterly, semi-annually, annually, biennially, triennially. If skipped yearly price is returned.
• button_text: Text to show on button.

Displays order link for given WHMCS Service (Hosting Plan). Service id is the only required parameters, if no other parameters is given yearly service price is returned.

[whmpress_order_link id = ""] [/whmpress_order_link]

Parameters

• id: Id of the service (Hosting Plan), You can find the IDs of all your services in WHMpress > Services/Products section.
• html_id: add a custom id to the table element for further CSS customization.
• html_class: Add a custom class to the wrapping HTML element.
• currency: Used with multi-currency, set the Currency in which price is displayed, if not mentioned session currency is used (which user have selected), if no session is found, currency set as default in WHMCS is used.
• billingcycle: Billing cycle of service, one from one-time, monthly, quarterly, semi-annually, annually, biennially, triennially. If skipped yearly price is returned.
• link_text: Text to show on link.

Returns the order url of WHMCS Service, useful for in-content linking and linking from images.

[whmpress_order_url id = "" ][/whmpress_order_url]

Parameters

• id: Id of the service (Hosting Plan), You can find the IDs of all your services in WHMpress > Services/Products section. Refer to article on more information on Finding  WHMCS Service IDs
• billingcycle: Billing cycle of service, one from one-time, monthly, quarterly, semi-annually, annually, biennially, triennially. If skipped yearly price is returned.
• currency: Used with multi-currency, set the Currency in which price is displayed, if not mentioned session currency is used (which user have selected), if no session is found, currency set as default in WHMCS is used.

Displays price of a WHMCS Service (Hosting Plan) for all billing cycle in dropdown list along with optional order button. Service id is the only required parameters,

 [whmpress_order_combo id = "" ][/whmpress_order_combo]

Parameters

• id: Id of the service (Hosting Plan), You can find the IDs of all your services in WHMpress > Services/Products section.
• html_id: add a custom id to the table element for further CSS customization.
• html_class: Add a custom class to the wrapping HTML element.
• combo_class: Add a custom class to the combo
• button_class: Add a custom class to the button
• currency: Used with multi-currency, set the Currency in which price is displayed, if not mentioned session currency is used (which user have selected), if no session is found, currency set as default in WHMCS is used.
• billingcycles: Billing cycle of service, one from one-time, monthly, quarterly, semi-annually, annually, biennially, triennially. If skipped yearly price is returned.
• decimals: how many decimals to show, if skipped no decimals are displayed.
• show_button: weather to show order button or not. Default is “yes”
• rows: 1 or 2
  • 1: Button is shown in same row along with price combo
  • 2: show button in next row, below the combo
• button_text: Text to show on button
• show_discount: weather to show discount or not. Default is “yes”
• discount_type: monthly or yearly
  • monthly: Additionally shows calculated monthly price with multiyear prices.
  • Yearly: Additionally shows calculated discount in % with multiyear prices.
• prefix: show currency prefix
• suffix: show currency suffix

Displays the currency being used to display prices.

[whmpress_currency][/whmpress_currency]

Parameters

• html_id: add a custom id to the table element for further CSS customization.
• html_class: Add a custom class to the <span> wrapping HTML element.

Shows a currency drop down to select currency if you are using multi-currencies. When user the currency it is set for user session.

[whmpress_currency_combo][/whmpress_currency_combo]

Parameters

• html_id: add a custom id to html wrapper for further CSS customization.
• html_class: Add a custom class to the apply to currency-combo wrapper
• combo_name: HTML name for combo
• combo_class: HTML class for combo
• prefix: show currency prefix

Displays a fancy domain search box with all the extension added in WHMCS. Submits the form to WHMCS domain search area.

[whmpress_domain_search ][/whmpress_domain_search]

Parameters

• html_id: add a custom id to the table element for further CSS customization.
• html_class: CSS class to apply on main wrapper div that holds all other elements.
• text_class: custom CSS class to apply on div wrapper for domain name text box
• combo_class: custom CSS to apply on div wrapper for domain ext. combo
• button_class: custom CSS to apply on div wrapper for button
• show_combo: yes or no, default value is yes.
• show_tlds: comma separated values of tlds to to list in combo. Only tlds that exists in WHMCS will be added. No spaces in comma separated values.
• show_tlds_wildcard: show only tlds matching with given string. Very useful if you want to show only tlds related to your country, e.g. “.in”
• button_text: Text to show on search button
• placeholder: Placeholder text for domain text box
• action: specify url where form will submit

[whmpress_domain_search_ajax][/whmpress_domain_search]

Parameters

• html_id: add a custom id to the table element for further CSS customization.
• html_class: CSS class to apply on main wrapper div that holds all other elements.
• text_class: custom CSS to apply on text box
• button_class: custom CSS to apply on div wrapper for button
• button_text: Text to show on search button
• placeholder: Placeholder text for domain text box
• action: specify url where form will submit, if not mentioned it will submit to same pag

[whmpress_domain_search_extended_ajax]

Parameters

• take same parameters as whmpress_domain_search_ajax

used to show the reuslts of domain_search_extended.

[whmpress_domain_search_ajax_extended_results]

Parameters

• searchonly: * or comma separated list of tlds to show

If you need support contact us via ticketing system at http://whmpress.com or on support@whmpress.com. Support questions are typically answered within 24 hours during working days.

Please note that we offer support for WHMpress plugin, its features and functionalities that are unique to it. Please provide us with as much information as possible when reposting an issue, include a link to your site, screenshots etc.

Please note that we cannot assist with general WordPress support or help with other plugins or theme modifications and customizations (big or small). You may consider our wordpress customization service listed on http://whmpress.com/prices page.

You will find list of useful resources related to WHMpress WordPress plugin, including link to official support and CodeCanyon sales page on official website http://whmpress.com